home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / inet / resource-guide / resource-guide-help < prev    next >
Text File  |  1993-01-21  |  17KB  |  385 lines
  1. Request: info
  2. Topic: help
  3. Document Updated: 21 jan 93
  4. Subject: 'Help' for request 'info' in the NNSC Info-Server
  5.  
  6.  
  7.                  'HELP' FOR THE NNSC INFO-SERVER
  8.  
  9.  
  10.             Table of Contents
  11.         
  12.         1.  INTRODUCTION - WARNINGS
  13.         2.  THE 'REQUEST:' COLLECTIONS - SELECTED DOCUMENTS
  14.         3.  CURRENT STATUS OF THE INFO-SERVER
  15.         4.  DETAILED INFORMATION ABOUT USING THE INFO-SERVER
  16.         5.  IF YOU HAVE PROBLEMS WITH LARGE MESSAGES
  17.         6.  ANONYMOUS FTP FOR INTERNET AND DIAL-UP IP USERS
  18.  
  19.  
  20. ******************************************************************************
  21.                 1.  INTRODUCTION - WARNINGS
  22. ******************************************************************************
  23.  
  24. The National Science Foundation Network Service Center (NNSC) operates
  25. the Info-Server for the purpose of providing important Internet
  26. documents by email. 
  27.  
  28.   *  HELP:  There is now one general 'help' document for the whole
  29.      Info-Server, which is the file you are now reading. It contains
  30.      over-all information about 'Request:' categories, and samples of
  31.      the most important or recent 'topic:' files under each 'Request:'.
  32.  
  33. To order this document, Send a message to info-server@nnsc.nsf.net.
  34. The Subject field does not matter and may be omitted. Place the
  35. following text in the body of the message:
  36.  
  37.     request: info
  38.     topic: help
  39.  
  40. This is the only 'Topic: help' in the Info-Server, and can be ordered
  41. from any of the 'Request:' categories
  42.  
  43.   *  INDEXES:  In most collections of information on the Internet, an
  44.      'index' is the name for a list of the files in the collection.
  45.  
  46. To order an 'index' of topics for a request category, e.g., nsfnet,
  47. use either of the following:
  48.  
  49.     Request: nsfnet
  50.     Topic: index-nsfnet
  51. or
  52.     Request: nsfnet
  53.     Topic: index
  54.  
  55.     *****************************************************************
  56.     *              WARNING - SEND REQUESTS TO INFO-SERVER           *
  57.     *  To prevent failed messages from causing infinite loops, the  *
  58.     *  mail address 'nnsc@nnsc.nsf.net' is placed in the From: and  *
  59.     *  Reply-To: field of the documents sent by the automated Info- *
  60.     *  Server.  But please do NOT use 'nnsc@nnsc.nsf.net' when you  *
  61.     *  order documents from the automated Info-Server.  You should  *
  62.     *  send document requests to 'info-server@nnsc.nsf.net'.        *
  63.     *****************************************************************
  64.     *   WARNING - RESTRICTION ON THE NUMBER OF TOPICS PER MESSAGE   *
  65.     *  The current version of the Info-Server ignores requests for  *
  66.     *  more than twenty (20) topics.  Please restrict the number    *
  67.     *  of "topic:" lines in any request message to twenty (20) or   *
  68.     *  fewer.  You may, however, send any number of separate        *
  69.     *  request messages.  For more information about ordering, see  *
  70.     *  Section 4 of this document.                                  *
  71.     *****************************************************************
  72.  
  73.  
  74. ******************************************************************************
  75.         2.  THE 'REQUEST:' COLLECTIONS - SELECTED DOCUMENTS
  76. ******************************************************************************
  77.                                (Size in Kbytes if >40K)
  78.  
  79. Requests and Topics            Descriptions
  80. (Use in request messages)      (Do NOT use in request messages.)
  81.        
  82. REQUEST: CALENDAR              EVENTS OF INTEREST TO THE INTERNET COMMUNITY
  83.   TOPIC: index-calendar        List of CALENDAR documents
  84.   TOPIC: jan                   Calendar for each of twelve consecutive 
  85.                                months, starting with the current month: 
  86.                                jan, feb, mar, etc. 
  87.  
  88. REQUEST: IESG                  IETF STEERING GROUP (IESG) 
  89.   TOPIC: index-iesg            List of minutes of IESG meetings
  90.  
  91.  
  92. REQUEST: IETF                  INTERNET ENGINEERING TASK FORCE (IETF)
  93.   TOPIC: index-ietf            List of IETF documents
  94.   TOPIC: 00README              Help for IETF collection.
  95.   TOPIC: 0...                  Information about upcoming meetings.
  96.                    (Files begin with 0 (zero). The "..."
  97.                    is NOT part of the file name.)
  98.   TOPIC: 1directories.txt      Information about IETF and INTERNET-DRAFTS
  99.                    collections of files.
  100.   TOPIC: 1...                  General information about the IETF, the
  101.                    working groups, and the internet-drafts.
  102.                                (Files begin with 1 (one). The "..."
  103.                    is NOT part of the file name.)
  104.  
  105.  
  106. REQUEST: INFO                  GENERAL AND MISCELLANEOUS TOPICS
  107.   TOPIC: help                  Help for the Info-Server (this document)
  108.   TOPIC: index-info            List of INFO documents
  109.   TOPIC: domain-info.txt       Top and second-level domains          (62K)
  110.   TOPIC: domains.txt           Top domains with IP numbers
  111.   TOPIC: interest-groups       Mailing lists (List of Lists)        (872K)
  112.                               
  113.  
  114. REQUEST: INTERNET-DRAFTS       MIRROR OF FILES ON NIC.DDN.MIL
  115.                    (An Internet Draft is a document that has
  116.                    been proposed to become an RFC.)
  117.   TOPIC: index-internet-drafts List of INTERNET-DRAFTS
  118.   TOPIC: 1id-abstracts.txt     Short synopsis of each document.      (81K)
  119.                                   
  120.  
  121. REQUEST: INTERNET-SOCIETY      See REQUEST: ISOC
  122.  
  123.  
  124. REQUEST: INTERNET-TOUR         INTERNET OVERVIEW FOR NOVICE NETWORK USERS    
  125.                    (This Hypercard 2 stack requires a MacIntosh 
  126.                    System Version 6.0.2 or higher.)
  127.   TOPIC: index-internet-tour   List of INTERNET-TOUR documents
  128.   TOPIC: Internet-Tour-README  How to Get and Install the INTERNET TOUR
  129.   TOPIC: Internet-Tour4.0.2.sit.hqx  Internet Tour files, compressed and
  130.                                      stored in binhex format
  131.  
  132.  
  133. REQUEST: ISOC                  INTERNET SOCIETY (ISOC)         
  134.   Topic: index-isoc            List of ISOC documents
  135.   Topic: announcement          Announcing the formation of the ISOC
  136.   Topic: charter               The ISOC charter
  137.   Topic: inet-conference       Networking Conference, June 1992
  138.   Topic: questions-and-answers Perspective on ISOC objectives
  139.  
  140.  
  141. REQUEST: NSFNET                DOCUMENTS ABOUT THE NSFNET
  142.   TOPIC: index-nsfnet          List of NSFNET documents
  143.   TOPIC: internet-overview     NSFNET Overview and Introduction
  144.   TOPIC: nnsc                  What is the NNSC?
  145.   TOPIC: networks              Networks on the NSFNET Backbone
  146.   TOPIC: referral-list         NNSC Network Provider List
  147.  
  148.  
  149. REQUEST: PHONEBOOK             INTERNET MANAGER'S PHONEBOOK
  150.   TOPIC: index-phonebook       List of PHONEBOOK documents
  151.   TOPIC: README                Announcement of Online Phonebook
  152.   TOPIC: phonebook.txt         Electronic version of the printed
  153.                    'Internet Manager's Phonebook' 
  154.                                published by the NNSC.
  155.  
  156. REQUEST: POLICIES-PROCEDURES   Information about the policies and procedures
  157.                                of the NSFNET  and its associated networks.
  158.   TOPIC: index-policies-procedures
  159.  
  160. REQUEST: RESOURCE-GUIDE        NNSC'S OWN GUIDE TO INTERNET TREASURES
  161.   TOPIC: index-resource-guide  List of RESOURCE-GUIDE documents
  162.   TOPIC: README                Help file for getting the Resource-
  163.                    Guide by FTP (File Transfer Protocol)
  164.   TOPIC: front-matter          cover, introduction, list of chapters, etc.
  165. [For a description and list of sections for each chapter, see below.]
  166.   TOPIC: intro1                Chapter 1. Computational Resources 
  167.   TOPIC: intro2                Chapter 2. Library Catalogs
  168.   TOPIC: intro3                Chapter 3. Archives
  169.   TOPIC: intro4                Chapter 4. White Pages
  170.   TOPIC: intro5                Chapter 5. Networks
  171.   TOPIC: intro6                Chapter 6. Network Information Centers
  172.   TOPIC: introM                Chapter M. Miscellaneous
  173.  
  174.  
  175. REQUEST: RFC                   RFCS FROM NIC.DDN.MIL
  176.   TOPIC: index-rfc             List of RFC and FYI documents        (46K)
  177.   TOPIC: fyi-index.txt         The official list of FYI (For Your
  178.                                Information) documents.  Each FYI is
  179.                    also an RFC.
  180.   TOPIC: rfc-index.txt         The official list of RFCs           (168K)
  181.   TOPIC: rfc-by-author.txt     List of RFCs, sorted by author       (25K)
  182.   TOPIC: rfc-by-title.txt      List of RFCs, sorted by title        (68K)
  183.   TOPIC: rfcNNNN               Individual RFC, where NNNN stands for a
  184.                    3 or 4 digit number, e.g., RFC822 or
  185.                    RFC1340.
  186.  
  187.  
  188. REQUEST: THE-SCIENTIST         THE SCIENTIST NEWSPAPER
  189.   TOPIC: index-the-scientist   List of available issues of "The Scientist"
  190.                    and other documents.
  191.   TOPIC: overview              Overview of "The Scientist" newspaper project  
  192.   TOPIC: the-scientist-yymmdd  Individual issue of "The Scientist" where
  193.                    yymmdd is a date, e.g., 921109 = 9 Nov 92.
  194.  
  195.  
  196. ******************************************************************************
  197.            3.  CURRENT STATUS OF THE INFO-SERVER
  198. ******************************************************************************
  199.  
  200. NNSC, the NSF Network Service Center, and CSNET, the Computer+Science
  201. Network, shared the operation of the Info-Server on the host sh.cs.net
  202. until CSNET ceased operations on September 25, 1991.  At that time,
  203. the Info-Server was taken over by the NNSC and moved to the host
  204. nnsc@nnsc.nsf.net.  The NNSC Info-Server continues to supply on-line
  205. services to the Internet community and to other networks that have
  206. email access to the Internet.
  207.  
  208. The NNSC Info-Server continues to distribute Info-Server documents for
  209. request categories NSFNET, CALENDAR, and RESOURCE-GUIDE.  In addition,
  210. we have added the former CSNET request categories INFO and RFC, and
  211. the new categories IESG, IETF, INTERNET-DRAFTS, INTERNET-TOUR, ISOC,
  212. and PHONEBOOK.
  213.  
  214. We have had to suspend temporarily the popular request category
  215. MOD-SOURCES (comp.sources.unix), but we hope to be able restore it in
  216. the near future.
  217.  
  218. The NNSC staff is reviewing and modifying the NNSC Info-Server
  219. offerings.  Further changes will be announced in this HELP document.
  220. If you have questions or suggestions, send them to
  221. 'nnsc@nnsc.nsf.net'.
  222.  
  223. You are encouraged to suggest additional documents you would like to
  224. have available from the NNSC Info-Server.
  225.  
  226. Thank you.
  227.  
  228. The NNSC Staff
  229.  
  230.  
  231. ******************************************************************************
  232.        4.  DETAILED INFORMATION ABOUT USING THE INFO-SERVER
  233. ******************************************************************************
  234.  
  235.     *****************************************************************
  236.     *              WARNING - SEND REQUESTS TO INFO-SERVER           *
  237.     *  To prevent failed messages from causing infinite loops, the  *
  238.     *  mail address 'nnsc@nnsc.nsf.net' is placed in the From: and  *
  239.     *  Reply-To: field of the documents sent by the automated Info- *
  240.     *  Server.  But please do NOT use 'nnsc@nnsc.nsf.net' when you  *
  241.     *  order documents from the automated Info-Server.  You should  *
  242.     *  send document requests to 'info-server@nnsc.nsf.net'.        *
  243.     *****************************************************************
  244.     *   WARNING - RESTRICTION ON THE NUMBER OF TOPICS PER MESSAGE   *
  245.     *  The current version of the Info-Server ignores requests for  *
  246.     *  more than twenty (20) topics.  Please restrict the number    *
  247.     *  of "topic:" lines in any request message to twenty (20) or   *
  248.     *  fewer.  You may, however, send any number of separate        *
  249.     *  request messages.                                            *
  250.     *****************************************************************
  251.  
  252. The NNSC Info-Server is an automatic program that delivers information
  253. by electronic mail.  To order a document from the Info-Server, send a
  254. message to 'INFO-SERVER@nnsc.nsf.net'. You do not need a subject field. The 
  255. text of your message must be in a special format, such as:
  256.  
  257.      REQUEST: INFO
  258.       TOPIC: HELP
  259.       TOPIC: INDEX
  260.      REQUEST: END
  261.  
  262. This request asks for two documents 'HELP' (this document) and 'INDEX'
  263. from the collection 'INFO'. Your message must have a 'REQUEST:' line,
  264. and one or more 'TOPIC:' lines to specify one or more documents.  As
  265. noted above, you should not put more than twenty (20) 'TOPIC:' in any
  266. one request message.  'REQUEST:' and 'TOPIC:' must be on a separate
  267. lines.  The line 'REQUEST:  END' is optional; it tells the Info-server
  268. to ignore the rest of the message.
  269.  
  270. To send documents to an address that is different from the address in
  271. your From: field, include a Reply-to: field in the header of your
  272. message.  Do NOT include a Reply-to: or Acknowledge-to: field in the
  273. body of the message -- the Info-Server won't recognize them.
  274.  
  275. For each request message, the Info-Server generates a receipt message
  276. which includes the list of documents sent, a report of errors in the
  277. request, and, if a Reply-to: field is used, the address in the From: 
  278. field of the request message.  (The Info-Server does not generate
  279. receipt messages for request messages with more than twenty (20)
  280. 'TOPIC:' lines.)
  281.  
  282. You may combine different requests in the same message, and use any
  283. combination of upper- and lower-case letters in your text.  You may
  284. also include or omit spaces and tabs, use any number of 'REQUEST:'
  285. lines, place any number of 'TOPIC:' lines under each 'REQUEST:', and
  286. omit 'REQUEST: END'.
  287.  
  288.         REQUEST     : info
  289.           byte-limit: 22000
  290.           topic:      interest-groups  (Byte-limit in effect; see below)
  291.     topic:  domain-info.txt
  292.     request:   internet-drafts     
  293.          TOPIC:    1id-abstracts.txt   (Byte-limit not in effect)   
  294.         Request :     rfc
  295.           TOPIC  :    rfc822         
  296.  
  297. If you include 'REQUEST: END', the Info-Server will ignore whatever
  298. follows in your message.  Please do NOT put questions for the NNSC
  299. staff in the request messages to the info-server.  Send them directly
  300. to 'nnsc@nnsc.nsf.net'.
  301.  
  302.  
  303. ******************************************************************************
  304.               5.  IF YOU HAVE PROBLEMS WITH LARGE MESSAGES
  305. ******************************************************************************
  306.  
  307. The NNSC Info-Server is now configured to split documents into a 
  308. maximum size of 40000 bytes (40K bytes).  The reason is that some
  309. important mail gateways reject messages longer than an arbitrary limit,
  310. and others have difficulty with long messages from time to time.
  311.  
  312. You may specify a limit, in lines or bytes, to the maximum size of
  313. document that you wish to have sent in a single message.  For example:
  314.  
  315.      LINE-LIMIT: 1000         or          BYTE-LIMIT: 25K
  316.  
  317. The Info-Server will break the documents at exactly the specified
  318. number of lines, or at the line preceding the specified number of
  319. bytes.  The minimum limit is 250 lines or 19000 bytes.  You may use
  320. the form '25000' or '25K' in either limit, but NOT '5,000'.  The limit
  321. affects only lines up to the next REQUEST: line.
  322.  
  323. To allow for added header lines, you should set your limit at least 5K
  324. lower than the limit set by your gateway.
  325.  
  326.  
  327. ******************************************************************************
  328.             6.  ANONYMOUS FTP FOR INTERNET AND DIAL-UP IP USERS
  329. ******************************************************************************
  330.  
  331. You may use the file transfer protocol, 'ftp', to retrieve documents
  332. from NNSC.NSF.NET.  Log in as 'anonymous' with password 'guest'.
  333.  
  334. Info documents are individual files in the directory 'info'.  For
  335. example, a copy of 'interest-groups-announcement' has the pathname
  336. 'info/interest-groups-announcement'.  To see what is in the top-level
  337. directory, use the 'ls' or 'dir' commands.  'ls' shows filenames only;
  338. 'dir' is the equivelent of the command 'ls -ls'; it shows a more
  339. verbose display, and puts the filenames in alphabetical order.
  340.  
  341. ftp> ls
  342. 200 PORT command successful.
  343. 150 Opening ASCII mode data connection for file list.
  344. test
  345. info
  346. calendar ...
  347.  
  348. ftp> dir
  349. 200 PORT command successful.
  350. 150 Opening ASCII mode data connection for /bin/ls.
  351. total 1845 ...
  352. drwxr-xr-x  2 nnsc     nnsc          512 Apr 20  1987 bin
  353. drwxrwxrwx  2 nnsc     nnsc         1024 Jan 27 21:01 calendar
  354. drwxr-xr-x  2 nnsc     nnsc          512 Dec 16 03:38 dev ...
  355.  
  356. You can use 'ls' or 'dir' to show pathnames of lower-level
  357. directories on nnsc.nsf.net.
  358.  
  359. ftp> dir info/i*
  360. -rw-rw-r--  1 nnsc     nnsc         7774 Feb  4 15:58 iin
  361. -rw-r--r--  1 nnsc     nnsc         4565 Jul 17 06:15 index-info
  362. -rw-rw-r--  1 nnsc     nnsc       879381 Apr  6 14:15 interest-groups
  363. -rw-rw-r--  1 nnsc     nnsc         2156 Feb  5 20:02 interest-groups-announcement
  364.  
  365. But note that when you transfer a file from a lower-level directory
  366. nnsc.nsf.net (the remote host) to your local host, you cannot use the
  367. pathname 'info/interest-groups-announcement'; instead, you must use two
  368. commands, 'cd' (change directory) and 'get'.
  369.  
  370. ftp> cd info
  371. 250 CWD command successful.
  372. ftp> get interest-groups-announcement
  373.  
  374. To return to the top-level directory, type
  375.  
  376. ftp> cd /
  377.  
  378. A single topic may be split up into multiple files, in which case the
  379. document name may be a directory, and the individual files in the
  380. directory may have names such as 'part01'.
  381.  
  382. nnsc.nsf.net is a Unix host, so type all filenames as either upper or
  383. lower case, just as they appear in the 'ls' or 'dir' listing.
  384.                                                                         
  385.